Copyright: Helpfile Generated by HelpWriter!


NSS WallPaper
NSS WallPaper OCX for Visual Basic

Wallpaper your VB Forms, Property pages, and userdocuments.

Now you can wallpaper your VB forms just like you see on many internet sites and on some programs.  Add textures, binder style backgrounds or any other background to your compiled program.  Allow your end users to set their the background in your program just as easily as they can change the Windows 95 background.

Add the control and one line of code  to give your program the professional look.

In the Form Load Event type the following:  replace "Your Project Name" with your program name.  Replace Form1 with your form or picturebox name.

NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form1

If you want a fixed background that will never change, then change "Your Project Name" to "".  Then it will use your default picture you assign in the Wallpaper control.

If you wish to allow your end users to change the background on your compiled program then create a menu option or command button and add the text below.  Again replace "Your Project Name" with your program name.   Make sure you use the same "Your Project Name" in your load and change events.

NSS_WPPR1.GetNewWallpaper "Your_Project_Name", Form1

NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form1

Following are additional help topics that will answer your questions!

Properties -  Adj_Height, Adj_Width, Center_Picture

What is "Your Project Name" and how does it affect the background?

Can I center a single picture?

How do I place backgrounds on additional forms?

How can I paint my other controls?

Why does it not paint the complete form?

How do I purchase NSS WallPaper?

Order Form

I have purchased it but it says I am not licensed, what now?

License Agreement

What files do I distribute with my completed program?

Who makes NSS WallPaper?

Help file generated by VB HelpWriter.


How do I place pictures on additional forms
How do I place backgrounds on additional forms?

Take the same command as you used on your main form, as follows:

NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form1

Now change the line as follows where form1 is the name of the form where your NSS_WPPR control resides.

form1.NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form2

So you take the original form name since that is where the NSS_WPPR control is and then you send your new form, in this case form2, to be painted.

Another option is to add another NSS_WPPR control to the new form.  But this is not needed unless you plan on using a fixed wallpaper for this separate form.

            Help file generated by VB HelpWriter.


Why does it not paint the complete form?

If you have this problem you can do the following:  I

Change the properties for AdjWidth and AdjHeight.

This should take care of it.

Help file generated by VB HelpWriter.


How can I paint my other controls?

Labels: Set the backstyle as follows, backstyle=0-Transparent.  This will allow the background to show through.

Tab Controls: Since most tab controls do not support the paintpicture event you need to do the following (and in actuality this is faster for most processing anyway).  Create your tab control.  Then create a picture box control.  Copy the picture box control  and paste it to create an array.  Create as many picture boxes as you will have tabs.  Then place all your controls on the picture box controls.  When the user presses tab 0 then set picture1(0).visible=true and set the previous one to false.  In a module that you can call from your form load event type the following and change them to fit your preferences.  Also set the picture frame=none.

  'resize picture boxes and paint

  Dim c As Integer

  For c = 0 To Picture1.UBound

    Picture1(c).Top = Tab1.Top + 350 'moves the picture box down so label shows

    Picture1(c).Left = Tab1.Left + 50 '

    Picture1(c).Height = Tab1.Height - 350

    Picture1(c).Width = Tab1.Width - 100

  Next

Set your top, left, height and width properties to be equal to your tab control.  By doing this you won't be able to tell the difference between having the controls on the tab control verses on the picture frame controls.

Then when you want to paint the picture boxes do the following.  This assumes you have created a picture box array named  tabpicture.

dim icount as integer

for iCount=0 to tabpicture1.ubound

  NSS_WPPR1.LoadWallpaper "Your_Project_Name", tabpicture1(iCount)

next

This will paint all the picture boxes the same as your form.

Check & Option Buttons: If you load from the components section "Microsoft Forms Object Library" it will provide you with a new set of controls for the command, check, option and other controls.  These controls have the setting to set it as "transparent" in the form of backstyle = 0-frmbackstyletransparent

Standard Command buttons:  This is where the program does something a little different.   If it finds that the Paintpicture event does not work then it will let the controls picture property equal your background.  For instance, if I have a command button array and it does not have transparent capability, but it does allow a picture property, then you would send the following code:

dim iCount as integer

for iCount=0 to command1.ubound

  NSS_WPPR1.LoadWallPaper "Your_Project_Name", command1(Icount)

  'The normal style property is 0.  You must change it to 1 for graphical.

  command1(iCount).style=1

next

This will change all the command1(iCount).Picture properties to equal the same background.

            Help file generated by VB HelpWriter.


What is "Your Project Name" and how does it affect the background
What is "Your Project Name" and how does it affect the background?

This setting should be your program name.   If you intend to allow your end users to change the background on your compiled program then you should use this setting.  Otherwise just place quotes ("").  NSS WallPaper will take the program name and write it to the registry.  It will also take the new background selected and write that to the registery as well.  Then the next time the program is run, it will read from the registry and load that background or backgrounds.

If you have a menu option for the user to change the background on your program, then when they change it, it writes to the registry so that the next time that user runs your program it will pull that file for the background.  So each user could have their own background settings for your program.   Each user who uses your program could have a different background at each computer.

If you will have fixed backgrounds and never want them changed then send "" for the program name:

NSS_WPPR1.load_picture "", Form1

            Help file generated by VB HelpWriter.


Who Makes NSS WallPaper

Nelson Software Solutions

Gil Nelson

15411 Via La Gitano

Poway CA 92064

USA

gr_nelson@compuserve.com, gr_nelson@cari.net

http://ourworld.compuserve.com/homepages/gr_nelson

Help file generated by VB HelpWriter.


How do I register?

There are three ways to register:

1) Via the CompuServe ShareWare Service GO SWREG ID# 16420.

$29.00 (Compuserve charges 15% for their service)

2) Via the kagi.com internet shareware service.  You may obtain the registration program from my web site http://ourworld.compuserve.com/homepages/gr_nelson.

$26.00 (Kagi charges 8% for their service)

3) Use the Order Form to Send a Check, $23.00  US Dollars to:

Nelson Software Solutions

Gil Nelson

15411 Via La Gitano

Poway CA 92064

USA

When payment has been received you will be sent the registered version.  Please specify how you would like to receive the registered version: Email, Postal Mail or Fax.

            Help file generated by VB HelpWriter.


I've Purchased NSS WallPaper, What Now?

You will recieve an unlock code via email or postal mail if requested.  The unregistered version will pop up with the message about registration during development and compiled programs.  Once you register it with the unlock code this message will no longer appear.  You will need to add the NSS_WPPR.OCX to your new project.   To do this select Project from the menu and then Components.   Check the box for NSS WallPaper.   Then do the following:

1) Place a control on a form

2) Set focus on the control

3) Press <F4> to bring up the properties screen

4) Click on custom to bring up the properties page

5) There are three tabs.

6) User the first tab to select a picture for your background.

7) The second tab shows information about NSS.

8) The third tab shows who has registered this control.

After this is complete you should be ready to use your new control.

Help file generated by VB HelpWriter.


What is the one line of code to load the background?

You would change "Your_Project_Name" to be your program name.

Then, where form1 is your form or other control property, type this line below to fit your needs:

NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form1

Help file generated by VB HelpWriter.


What is the one line of code to change my background?

NSS_WPPR1.GetNewWallpaper "Your_Project_Name", Form1

After you do change your background you must also do the LoadWallpaper as follows:

NSS_WPPR1.LoadWallpaper "Your_Project_Name", Form1

            Help file generated by VB HelpWriter.


What files do I distribute with my completed program?

Once you are ready to distribute your program you will include the NSS_WPPR.OCX.

You MAY NOT distribute your unlock code.   Please read the section under License Agreement.

            Help file generated by VB HelpWriter.


License Agreement

You should carefully read the following terms and conditions

before using this software.

The only file that may be distributed with your product is the file NSS_WPPR.OCX.

Under no circumstances may you give out your registration name or code.   It is a breach of this agreement to distribute this information.

One registered copy of NSS_WPPR.OCX may either be used by a single

person who uses the software personally on one or more computers,

or installed on a single workstation used nonsimultaneously by

multiple people, but not both.

You may access the registered version of NSS_WPPR.OCX through a network,

provided that you have obtained individual licenses for the

software covering all workstations that will access the software

through the network.

Disclaimer of Warranty

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND

WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY

OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.   Because of the

various hardware and software environments into which NSS_WPPR.OCX

may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS

OFFERED.

Good data processing procedure dictates that any program be

thoroughly tested with non-critical data before relying on it.

The user must assume the entire risk of using the program.  ANY

LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT

REPLACEMENT OR REFUND OF PURCHASE PRICE.

Help file generated by VB HelpWriter.


Order Form

Nelson Software Solutions

15411 Via La Gitano

Poway Ca 92064

U.S.A.

(619) 487-3107

CompuServe ID:102105,1172

Email:gr_nelson@compuserve.com

http://ourworld.compuserve.com/homepages/gr_nelson

NSS WallPaper Order Form

To order, please complete the following information:

Name: _________________________________________________

Address: ___________________________________________________

Address: ___________________________________________________

City:  _____________________ State:_____ Zip:____________

Phone:   (______) ________-____________

Contact person:  _______________________________________________________

There are three ways to register.  If using this form and sending a check then you would select the first option.

1) $23.00 US Dollars

2) $29.00 Via CompuServe Shareware Service.  Registration ID# 16420.

3) $26.00 Via Kagi.com internet shareware service.  To use this method run the register.exe program that came with NSS WallPaper.  This program allows you to use a credit card to register via the internet.  The credit card information is encrypted when transmitted.

Number of Copies requested: [     ]

Please check the desired method to receive the unlock code.

[ ] Email_________________________________________

[ ] Mail

[ ] Fax __________________________________________

Thank You for your order.

Help file generated by VB HelpWriter.


Can I center a single picture?

Yes!  Version 1.01 added this feature.

Change the Property Center_Picture  to True.  If you have a photograph that you want to center and not tile then set this to true.  The default is tile.

NOTE:  If you select to center a single picture then you should  add the following code to your form resize procedure.

Sub Yourformname_Resize ()

CLS

NSS_Wppr1.LoadWallPaper "Your Application Name",form1

End Sub

This will ensure if the user changes the size of your form the picture will re-center itself.

            Help file generated by VB HelpWriter.


Properties -  Adj_Height, Adj_Width, Center_Picture

Adj_Height & Adj_Width - In some instances you may have a picture that you end up getting gray area showing through.  If this is the case adjust these two parameters in increments of around 20 until you get rid of the gray area.  Also please email me the graphic so I can resolve the issue for future releases.

Center_Picture - CenterPicture: Allows you to take a photograph that you don't want tiled and it will place this in the center of the screen.

Help file generated by VB HelpWriter.